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COPYRIGHT 


COPYRIGHT c 1985 by Nicolet Test Instruments Division. All rights 
reserved. No part of these materials may be reproduced by any means, nor 
translated into a machine language, without the written permission of the 
publishers. 


LIMITED WARRANTY 


Nicolet Test Instruments Division guarantees your emulator against all 
defects in materials and workmanship for a period of ninety (90) days from 
the date of delivery to the original user. All instruments returned to 
Nicolet Test Instruments Division FREIGHT PREPAID during the ninety day 
period will be replaced or restored to proper working condition and returned 
to the sender without charge. We neither assume nor authorize any 
representative or other person to assume for us any other liability in 
connection with the sale on any shipment of our products. 


NOTE 


This warranty does not apply to damage caused by 
shipping, negligence, accident, unauthorized repair, 
abuse, misuse, or modification; or to inconven- 
iences or consequential damages occasioned by the 
instrument, or by breach of any expressed or 
implied warranty with respect thereto. Further, no 
agreement extending or modifying this warranty in 
any way whatsoever will be binding upon unless 
executed by a duly authorized officer of the 
company. 


This warranty gives you specific legal rights; you may also have other rights 
which depend on local jurisdiction. 


We reserve the right to make changes and improvements in our products 
without incurring any obligation to similarly alter products previously 
purchased. 


OUT OF WARRANTY REPAIRS 


A flat repair cost will be charged for an out-of-warranty product that is 
returned to Nicolet Test Instruments Division. This price includes return 
surface freight charges and necessary component replacement. 


Method of payment (included with emulator): check, credit card, COD or 
purchase order (approved by Nicolet Test Instruments Division). 


If a bank card is used, the following information is required: 


Card type (ie. VISA or Mastercard) 
Name as shown on card 

Credit card number 

Expiration date 
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If requesting COD repair, please so state when returning the unit. 


U.S. SERVICE CENTERS 


Nicolet Test Instruments Division Nicolet Test Instruments Division 
5225-2 Verona Road 215 Fourier Avenue 

Madison, WI 53711-0288 Fremont, CA 94539 

Tel: 608/273-5008 Tel: 415/490-8870 

Twx: 910/286-2737 (NICOLET MDS C) Fax: 415/490-8063 

Fax: 608/273-5061 

Nicolet Test Instruments Division Nicolet Test Instruments Division 
12 New England Executive Park 2181 Northlake Parkway, Suite 118 
Burlington, MA 01803 Tucker, GA 30084 

Tel: 617/273-4404 Tel: 404/491-0127 

OVERSEAS: 


Contact your local distributor for the address of Nicolet Service Center nearest you. 
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CHAPTER 1 
INTRODUCTION 


ABOUT NICE, THE Z80+ EMULATOR 


The NICE Z80+ begins a new generation of medium-to-high function emulators. Its 


revolutionary compact design provides the following benefits: 


oO 


Reduction in Price. NICE's low price finally brings In-circuit emulators 
out of the exclusive domain of large-scale operations and into the reach of 


computer repair shops and hobbyists. 


Transportability. NICE is only 34" X 54" and 1" thick. Not only can it be 
used in development labs, it can also be a part of the computer technician's 
portable repair kit. An RS232 compatible interface allows NICE to hook up 


to most terminals and modems for speedy diagnoses. 


Full Speed Emulation with Minimal Target Disturbance. NICE's compact 
design means the electronics are closer to the target system than previous 
generation emulators. The result is full speed emulation with minimal 
target disturbance. The NICE Z80+ includes a Molex connector to tap into 
an external power supply with a requirement of approximately LA @ 5.2V. 


Ease of Operation. NICE's streamlined operation is consistent with its 
streamlined design. All it takes to get started is replacing the Z&80 
microprocessor with NICE (either directly or via the 40-pin cable assem- 
bly), connecting the terminal to NICE, resetting the target system, and 


hitting a carriage return. 


WHO USES IT? 


NICE is designed to meet the needs of four groups: 


Designers profit from NICE's ability to aid in debugging both hardware and 
software. Emulators provide a cost-effective means of integrating hard- 


ware and software. 


New Product Manufacturers can use NICE to pinpoint potential problems 
before beta testing. During the manufacturing, NICE can be used to bring 
up virgin CPU cards, then to download and run diagnostics. A more 


trouble-free product leads to greater customer satisfaction. 


Computer Repair Technicians can bring NICE along on on-site repair calls, 
possibly eliminating the need for in-shop repair. Smaller computer repair 


shops can finally afford an emulator because of NICE's low cost. 


Serious hobbyists can even use NICE. Its low cost and high versatility 
combine to make it a valuable tool for debugging home systems and 


designing custom hardware or software. 


BASIC FEATURES 


Despite its small size, NICE incorporates most of the features of the less portable 


and more expensive emulators. 


oO 0 60 86 8 86 


Full speed execution up to 8MHZ 

Refresh function maintained at all times 

All I/O ports available to user 

All memory addresses available to user 

Three software breakpoints with 8-bit loop counters 
Three software printpoints with 8-bit loop counters 


Sixteen real-time hardware breakpoints 


o oOo 0 0 0 6 8 8 


Sixteen hardware printpoints 

Eight Kbytes of overlay RAM hardware 

Interface to user via standard 25-pin RS232 termina! connector 
Local or remote operation 

Automatic baud rate detection 

Small size 

Low cost 

High reliability 


FUNCTIONAL CAPABILITIES 


NICE can perform the following: 
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Execute real time (hardware) breakpoints 

Operate from overlay RAM 

Perform user-definable histogramming 

Display target system memory in hexadecimal and ASCII format 
Display and modify any memory location in target system RAM 
Display and/or modify any Z80 interna! register 
Examine any I/O port 

Output single or multiple bytes to any I/O port 

Perform hexidecimal arithmetic 

Fill a block of RAM with a constant 

Compare one block of memory to another 

Test target system RAM 

Move a block of memory from one location to another 
Read and load an Intel Hex File into target system RAM 
Trace and display all instructions 

Trace and display only specified instructions —--— 
Upload Intel HEX File to Host 

Disassemble memory into Z80 mnemonics 

Assemble Z80 mnemonics into memory 

Enable/Disable Z80 interrupts in hardware 
Enable/Disable Z80 bus request in hardware 
Enable/Disable Z80 refresh function 
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COMMAND LINE INTERPRETER CHARACTERISTICS 
NICE's versatile command line interpreter allows you to perform the following: 


Enter one or more commands on the same line 
Enter a "Sleep" command to delay command execution 
Enter a "Repeat Line" command to repeat execution of the command line 


Erase the previous character on the command line 


o oOo 6&6 6 86 


Erase the entire command line 


Additionally, a printout can be halted, restarted, or aborted. 


CHAPTER 2 
SET-UP 


There are two aspects to setting up NICE for Z80 emulation: 


1. Setting up the terminal, 
2. Establishing the communications interface and installing NICE into the target 


system. 
TERMINAL 
Auto Baud Rate Detection 


NICE is equipped with an automatic baud rate detection algorithm that is invoked 
whenever NICE is powered up. To determine the proper baud rate, NICE measures 
the length of the first start bit transmitted from the terminal. To start automatic 
baud rate detection, enter a carriage return following power up. After the baud 
rate has been determined, you will see the NICE prompt which, is a greater than 


sign (>). At this point, you may begin entering commands. 


To work with NICE, the terminal must be set to one of the following baud rates: 


o §=6150 o 2400 
o 300 o 4800 
o 600 o 9600 
o 1200 o 19.2k 


Terminal Characteristics 


To operate with NICE, the terminal must be set up with the following 


characteristics: 
o Full duplex operation 
o = Auto line feed on; carriage return disabled 
o Line terminator set to either carriage return or line feed 
o Destructive space enabled 


o 8668 bits of data 
o = Parity disabled 
o 2stop bits 


COMMUNICATIONS INTERFACE 
RS232 Considerations 


NICE uses RS232 for communications. RS232 is a standard serial asynchronous 
protocol. However, NICE uses only those signals defined in the RS232 specifications 
that are necessary for its operation. While the typical voltage levels for RS232 are 
+12 and -12 volts, NICE uses +3 and -3volts for the corresponding levels. 


WARNING 


The +12 and -12 volt signals from the terminal are 
clamped to +5 and 0 volts by diodes inside NICE. 
Since excessive current could damage the clamping 
diodes and/or custom circuits, be sure that you 
only use RS232 compatible devices with NICE. 
And never connect NICE to a device capable of 
supplying or sinking more than 15 mA of current. 


Setting up the Communications Connector 


Before you configure the pins on the communication cable, determine whether you 
will be connecting via the Data Terminal End (DTE) or the Data Computer End 
(DCE). The DTE connection is the one most commonly used with NICE. Therefore, 


the cable provided is wired for connection to a terminal. 
The following list provides the pin numbers, signal names and functions for the 
communication cable connector provided with NICE, as well. To connect NICE 


directly to a computer, you must rewire the connector to conform to the pin 


numbers in parentheses. 
PIN 3 (PIN 2) - Received Data, sent from NICE to the CRT terminal. 


PIN 2 (PIN 3) - Transmitted Data, sent to NICE by the CRT terminal. 


PIN 5 (PIN 4) - Clear to Send. This signal is sent by NICE to the terminal. A high 
signal (+5V) tells the terminal that NICE is ready to accept data. Use of PIN 5 
ensures that the terminal will not transmit at a rate faster than NICE can accept. 


PIN 20 (PIN 6) - Data Terminal Ready. This signal is sent to NICE by the terminal. 
A high signal tells NICE that the terminal is ready to accept data. Use of PIN 20 
ensures that NICE will not transmit data faster than the terminal can accept it. 

PIN 6 (PIN 20) - Data Set Ready. This signal is sent by NICE to the terminal. A 
high signal (+5V) tells the terminal that NICE has been installed and power has been 
applied to the target system. 

PIN 7 (PIN 7) - Ground, is the return path for the previous signals. 

INSTALLATION 

To install NICE: 


1. Remove the Z80 microprocessor from the target system. 


2. Connect NICE, using either the pin plug provided or the short 40 pin cable 


connector. 
o Whenever possible, use the pin plug. The pin plug reduces signal noise. Use 
the 40 pin cable only if you cannot physically attach NICE to the target 


system. 


o Be sure that pin | of the target system is connected to pin 1 of NICE. 


Otherwise, you may damage NICE's custom circuits. 


3. Attach the terminal to NICE using the communication cable provided. 


4. 


NB: 


Users may wish to use their own power supply; the pin-out from the emulator is 
as follows. Numbering from right to left as shown in Figure | below. 


Pin 1 +5.2V 

Pin 2 Ground 

Pin3 Sync Out (Positive True) 

Pin4 External Break In (Negative True) 
Pin 5 Ground 

Pin 6 +5.2V 


Pin 4 (Input) A negative true logic signal applied to this pin will cause a 


hardware (real time) breakpoint to be performed. 


Pin 3 (output) This signal is active 95nS (worst case) following detection of the 
hardware breakpoint or printpoint address. May be used to initiate or trigger 
external hardware such as: oscilloscopes, logic analyzers, etc. 


Ensure terminal characteristics are set correctly (see Page 5) and apply power 
to the system in the following order. First the TERMINAL next the 
EMULATOR finally the TARGET SYSTEM. 


Figure 1 Molex Pin Orientation. 


CHAPTER 3 
COMMAND LINE INTERPRETER 


COMMAND FORMAT 


Spaces -- NICE is controlled by simple one- to three-character commands entered 
at the terminal. Spaces are ignored, with one exception: a space must follow a 
command when the command is used with a parameter. Character data may be 


entered either in upper or lower case. 


Multiple Parameters -- When there are multiple parameters in a command, the 


parameters must be separated either by commas or by spaces. 


Length -- The command line can contain a maximum of 31 characters. The 
terminal emits a beep once you have reached the 31-character limit. Any additional 
characters typed after the beep replace the last character on the line. 


Execution -- NICE executes the commands on the command line when it receives a 


terminator character (Line Feed or Carriage Return) from the terminal. 

COMMAND PARAMETERS 

Certain commands require either alphabetic or numeric parameters. Numeric 
parameters must be entered in hexadecimal form, they can be either an 8 bit or 16 
bit value, depending on the command. 


COMMAND LINE PROMPTS 


NICE displays two different prompts depending on the success of the previous 
command. 


o The OK prompt (>) indicates the previous command was executed properly and 


that NICE is awaiting the next command. 


o The ERR prompt (<) indicates the previous command was either entered 


incorrectly or its execution terminated abnormally. The ERR prompt is 
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displayed in conjunction with an audible warning. A new command may be 


entered following the arrow. 
MULTIPLE COMMANDS ON ONE LINE 


NICE will execute several commands entered on the same line. Each command must 


be separated by a semicolon. 
For example, the following command 
D E000; F 8000, 8800, AB 


causes NICE to execute the Display memory command followed by the Fill memory 


command. 
CONTROL CHARACTER FUNCTIONS 


Four control codes are used to aid in entering commands and control printout. To 


enter a control character, hold down the CTRL key as you hit the indicated letter. 


Table 3-1 
Control Characters and Their Functions 


ep  R 
ee EA PO 


Character Function 


Pr nee RY PE eS parnteoSSa 


Ctrl-H Performs the same function as the backspace key: Back- 
spaces and deletes the previous character. 


Ctrl-U Erases all the previous characters on the command line and 
positions the cursor at the beginning of the command line. 


Ctrl-S Starts or stops printout at the terminal. If printing, Ctrl-S 
stops the printing. If printing is already stopped, Ctrl-S or 
any other character causes printing to resume. 

Ctrl-C Aborts a printout or terminates a Repeat Line Command. 


For printouts, the abort takes place at the end of the next 
line of text. 
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REPEAT LINE COMMAND 


The Repeat Line Command (RL) instructs NICE to repeat the command(s) on that 


line over and over again. 
For example, the following command 
D E000; F 8000, 8800, AB; RL 


causes NICE to execute the Display memory command and Fill memory command 


over and over. 


NICE only ceases executing the commands on the command line when it receives a 


Ctrl-C from the terminal or when the target system is reset. 
COMPUTER INTERFACE TO THE COMMAND LINE INTERPRETER 


When you communicate with NICE using a computer instead of a terminal, NICE's 
response to ASCII characters is not always obvious. The responses which cannot be 


easily determined by viewing a CRT are listed below: 


Non-control characters are echoed exactly as received. 
Control characters are not echoed. 


Lower-case characters are converted to upper-case. 


o Oo 8 96 


You can terminate a command line with either a Line Feed or a Carriage 

Return. 

o A Line Feed followed by a Carriage Return signifies that NICE is sending a 
new line. 

o The response to a backspace (Ctrl-H) is the sequence Ctrl-H, space , Ctrl- 
H. (On a terminal, this sequence deletes one character.) 

o 6A Ctrl-U causes NICE to respond with the sequence Ctrl-H, space, Ctrl-H 

the number of times necessary to backspace and delete the entire line. 
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CHAPTER 4 
OVERVIEW OF OPERATIONS 


GO MODE VS QUIT MODE 
NICE has two different states of operation. 


In GO mode, NICE executes Z80 instructions at full speed, but only obeys a subset of 
its full repertoire of commands. NICE automatically enters the GO mode when you 
reset the target system. In QUIT mode, NICE obeys the full set of commands from 


the terminal, but it cannot execute instructions at full speed. 
Chapters 5 and 6 contain valid GO mode and QUIT mode commands. 


When you are not certain of NICE's current mode, you can issue the status command 
(STS M) from either mode. If the bottom line of the display includes the word 
"RUNNING," NICE is in the GO mode. Alternatively, depress the "return" key if a 
trancated version of the command set is displayed. The Z80 is then in the RUN 
mode. 


SPECIAL FACTS ABOUT NICE 


Because of NICE's compact new design, it behaves somewhat differently from larger 


emulators. 


Interrupts 


NICE has the capability of recognizing Z80 interrupts in the GO mode, but not in the 
QUIT mode. In GO mode, interrupts can be enabled or disabled from reaching the 


Z80 Microprocessor. 


Bus Requests 


NICE only recognizes Z80 Bus Requests when in the GO mode. In the GO mode, you 
can use one of the two GO mode commands to enable or disable Bus Requests to 
reach the Z80 Microprocessor. When NICE is in QUIT mode, Bus Requests are not 


allowed to reach the Z&0 Microprocessor. 
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NOTE 


If you use NICE in a system that requires continu- 
ous access to the memory bus (such as a CRT 
controller), you should expect an under run condi- 
tion when NICE enters the QUIT mode. 


Memory Refresh 


When NICE is in the QUIT mode, the Z80 control lines are cycled so that systems 
containing dynamic RAM will not lose data. The Refresh function is always enabled 


following power up. 


NOTE 


If the target system does not have dynamic RAM, 
it is a good idea to disable the Refresh function. 
This allows NICE to operate 25 percent faster. 


Memory Requests 


When NICE is in the GO mode, memory requests are identical to Z80 memory 


requests. When NICE is in the QUIT mode, however, requests are extended. 


NOTE 


The lines which control memory access with NICE 
in the target system are active for a longer period 
of time than they would be ordinarily. Therefore, 
during a memory read, be sure that data from the 
target system RAM remains valid for the entire 
period as indicated by the Z&80 control lines. 


I/O Requests 
When NICE is in the QUIT mode, I/O control signals are extended beyond ordinary 


duration. As with memory requests, then, be sure that I/O read data remains valid 


for the duration as indicated by the Z80 control lines. 
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Power Up Status 


After power up, the following occur: 


o NICE comes up in the GO mode, appearing to the target system as if it 


were a Z&0 microprocessor. 


o The interrupt request and bus request lines are enabled. 


o = All break point and print enable flags are cleared. 


o Saved memory address is set to zero. 


o Full speed execution starts at location zero. 


Then, once NICE receives a carriage return from the terminal and sets its internal 


baud rate, NICE enters the command line interpreter. 
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CHAPTER 5 
GO MODE COMMANDS 


In the QUIT mode, NICE recognizes all commands. In the GO mode, however, NICE 
only recognizes a subset of these commands. The commands that NICE recognizes 
in the GO mode follows 


Page # 

18 SBP - _ Breakpoint 

19 SBPC -  Breakpoint Count 

21 SEBP - Enable Breakpoint 

22 SDBP - Disable Breakpoint 

23 Sc - Clear Software Breakpoints 
24 SEPP - Enable Printpoint 

25 SDPP - Disable Printpoint 

26 EI - Enable Interrupts 

27 DI - Disable Interrupts 

28 EB - Enable Bus 

28 DB - Disable Bus 

29 DR  - _ Disable Refresh 

30 ER - Enable Refresh 

31 H - Hexadecimal Arithmetic 
32 Q - Quit 

33 RL - Repeat Line 

34 STS - Status 

36 Z - Sleep 


? - Request Information on Defined Command 
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SBP - BREAKPOINT 
Purpose 


Sets any of the three breakpoint addresses that work with either the Trace or 
Untrace commands. Software breakpoints only work in QUIT mode. 


Format 
SBP Breakpoint-Number, Breakpoint Address 


Breakpoint Number must be either 1, 2, or 3, corresponding to the desired break 
point. Breakpoint-Address is a 16-bit value which NICE saves for later comparison 


to the Z80 program counter during Trace and Untrace commands. 
Examples 


The following examples show how to set breakpoint addresses and use the Status 


(STS) command to display the results. 


? SBP 


SBP xyYYYY 
Set software breakpoint x (1-3) at address yyyy. 


> SBP 1,188@ 
> SBP 2,199@ 
> SBP 3,2080 
> STS 
---) 1808 68 D 
---) 1898 @8 D 
+ ---) 2008 60 D 
IBR RUNNING 


Overlay RAM is # DISABLED # at @OO8-IFFF R/W 
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SBPC - BREAKPOINT COUNT 
Purpose 


Specifies the number of passes NICE makes before stopping at the selected break 


point. 


NOTE 


Each of the three breakpoints has its own one-byte 
pass counter. Specifying a pass count allows NICE 
to trace a program past a particular address more 
than once before terminating with a breakpoint. 


After NICE traces each instruction, it compares the enabled breakpoint addresses to 
the program counter. If a match is found, NICE determines whether the pass 


counter is zero. 


o If the pass counter is zero, NICE stops tracing and sends the register display to 


the terminal. 


o If the pass counter does not read zero, then it is decremented and NICE 


continues tracing. 


Pass counters can also be used to determine the number of times a program passed a 


certain address. (NICE retains the decremented values even after it stops tracing.) 
Format 
SBPC Breakpoint-Number, Pass-Count 


The Breakpoint Number must be either 1, 2, or 3. The Pass-Count is a one-byte 


value. 
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Examples 


> ? SBPC 


SBPC x,yy 
Change software breakpoint pass counter x (1-3) to yy. 


> SBPC 1,9 
> SBPC 2,28 
) SBPC 3,7 

> STS 

~--) 1808 09 D 
---) 1898 28 D 
---) 2000 87 D 
IBR RUNNING 


Overlay RAM is # DISABLED # at @@88-1FFF R/W 
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SEBP - ENABLE BREAKPOINT 


Purpose 


Enables one or all three breakpoints. 


Format 


This command has two forms: 


1. SEBP - Enables all three breakpoints. 


2. SEBP Breakpoint-Number - Enables breakpoint 1, 2, or 3, as specified. 


Examples 


> SEBP 3 
> STS 
---> 1888 @9 D 
---> 1898 28 D 
~~~) 2088 @7 E 
IBR RUNNING 
Overlay RAM is # DISABLED # at GO0-1FFF R/W 
> SEBP 
) STS 
---) 1880 9 E 
---> 1898 28 £ 
~--> 2088 @7 £ 
IBR RUNNING 


Overlay RAM is ¢ DISABLED # at @OO8-1FFF R/W 
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SDBP - DISABLE BREAKpOINT 

Purpose 

Disables one or all three breakpoints. 
Format 

This command has two forms: 

1. SDBP - Disables all three breakpoints. 


2. SDPB Breakpoint-Number - Disables breakpoint 1, 2, or 3, as specified. 


Examples 


> ? SDBP 


SDBP x 
Disable software breakpoint x (1-3). 


> SDBP 1 

> STS 

---) 1888 69 D 
---) 1898 28 E 
~--) 2008 @7 E 
IBR RUNNING 
Overlay RAN is # DISABLED # at @O80-1FFF R/W 
> SDBP 

> STS 

---) 1008 69 D 
---) 1898 28 D 
~--> 2008 67 D 
TBR RUNNING 


Overlay RAM is # DISABLED # at @@08-IFFF R/W 
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SC - CLEAR ALL SOFTWARE BREAKPOINTS AND RESET PASS COUNTERS 


FORMAT 
SC 


EXAMPLE 
< ? SC 


SC 


Clear all software breakpoints and reset pass counters. 


< STS 


---> 1800 O9 E 
---> 1890 20 E 
---> 2000 07 E 
IBR RUNNING 


Overlay RAM is * DISABLED * at OQOO0-1FFF R/W 


> STS 


---> 9000 00 D 
—--> G000 00 D 
---> 0000 00 D 
IBR RUNNING 


Overlay RAM is * DISABLED * at O000-1FFF R/W 
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SEPP - ENABLE PRINTPOINT 

Purpose 

Enables one or all of the three printpoints. Printpoints are used in combination 
with the Untrace Command to generate the register display. Enabling the print 
point function allows NICE to trace a large number of instructions while displaying 
the registers only at specific addresses. The registers are displayed when: 

Oo a printpoint is enabled, and 

© a match is made between program counter and associated breakpoint address. 


NOTE 


The printpoint and breakpoint functions are 
independent. The only similarity is that they both 
use the same address for comparison. 

Format 

There are two forms of the SEPP command: 

1, SEPP - Enables all three printpoints. 

2. SEPP Printpoint-Number - Enables the specified printpoint. 

> ? SEPP 


SEPP x 
Enable software printpoint x (1-3). 
> SEPP 2 


> ST§ 

---> 1888 69 D 
---) 1898 28 DP 
---> 2808 87 D 
IBR RUNNING 


Overlay RAM is # DISABLED # at @O@O-IFFF R/W 
> SEPP 
> STS 

~--) 1808 09 DP 

~-~> 1898 28 D P 

---) 2008 87 DP 

IBR RUNNING 


Overlay RAM is # DISABLED # at @@@0-1FFF R/W 
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SDPP - DISABLE PRINTPOINT 


Purpose 


Disables one or all of the three printpoints. 


Format 


There are two forms of the DPP command: 


1. SDPP - Disables all three printpoints. 


2. SDPP Printpoint-Number - Disables the specified printpoint. 


Examples 


> ? SDPP 


SDPP x 
Disable software printpoint x (1-3). 


> SDPP i 
> STS 
---> 1808 69 D 
---) 1898 28D P 
~~~) 2088 @7 DP 
TBR RUNNING 
Overlay RAM is # DISABLED # at G@Q0-1FFF R/W 
> SDPP 
> STS 
~~~) 1888 69 D 
~--> 1896 28 D 
---) 2008 67 D 
IBR RUNNING 


Overlay RAM is # DISABLED # at @000-1FFF R/W 
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Ef - ENABLE INTERRUPTS 


Purpose 


Instructs NICE to allow hardware interrupts in GO mode if that capability has been 
disabled using the Disable Interrupts command. Interrupts are automatically 
enabled following power up of the NICE Z&0+. 


An “I" appears on the last line of the status display when interrupts are enabled. 


Examples 


>? El 
EI 
Enable 788 aaskable and non-maskable interrupts (default). 


> EI 
> STS 


---) 1888 @9 D 
---) 1898 28 D 
---> 2088 @7 D 
IBR RUNNING 


DI - DISABLE INTERRUPTS 
Purpose 


Instructs NICE to block interrupts so that they cannot reach the Z&0 
microprocessor. This function is useful for checking code since interrupts can be 
enabled or disabled during full-speed execution. If NICE did not have this 
capability, the alternative would be to disable interrupts in software. Not only does 
this method take time to compile the new object code, it corrupts the source. 
Further, it is not possible to disable the Z80 NMI interrupt in software. 


Examples 


Overlay RAM is # DISABLED # at @O88-1FFF R/W 


> Dl 

> STS 

~--) 1888 89 D 
~--> 1898 28 D 
---) 2008 87 D 
«BR RUNNING 


Overlay RAM is # DISABLED # at @@@8-1FFF R/W 
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EB - ENABLE BUS 


Purpose 


Instructs NICE to allow bus requests in GO mode if that capability has been disabled 
using the Disable Bus command. Bus requests are automatically enabled following 
reset of the target system. A "B" appears on the last line of the status display when 
the bus is enabled. 


DB - DISABLE BUS 
Purpose 


Instructs NICE to block bus requests so that they do not reach the Z80+ 
microprocessor. This function is useful for removing the asynchronous use of the 


address and data bus caused by DMA devices when you are checking a program. 


WARNING 
The DB command can stop a data transfer before it 
is completed. With devices such as disk drives, it 
is possible that data contamination could result. 


Examples 


> ? DB 


DB 
Disable 788 bus requests. 


> DB 

> STS 

---) 1688 69 D 
---) 1898 28 D 
---) 2888 @7 D 
«eR RUNNING 
Overlay RAM is enabled at EQQQ-FFFF R/W 
> EB 
> STS 

---) 1808 69 D 
---) 1898 28 D 
~--> 2008 €7 D 
-BR RUNNING 


Overlay RAM is enabled at EQQQ-FFFF R/W 
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DR - DISABLE REFRESH 


Purpose 


When NICE is in the QUIT mode, data is read every 1.25 ms from a minimum of 128 
consecutive memory addresses. This function maintains the dynamic memory 
refresh function. If your system does not contain dynamic RAM, you may disable 
the memory refresh function, allowing NICE commands to execute 25 percent 
faster. 


? OR 


DR 
Disable 78@ refresh during QUIT aode. 


> DR 

> STS 

~--) 1888 @9 D 
---) 1898 28 D 
~--)> 2008 @7 D 
IB. RUNNING 


Overlay RAN is enabled at E@QE-FFFF R/W 


“a 


ER - ENABLE REFRESH 
Purpose 


Instructs NICE to allow memory refresh if it has been disabled. The refresh 
. function is automatically enabled following system power up. An "R" appears on the 
last line of the status display when memory refresh is enabled. 


Examples 

> ER 

> STS 
---)> 1888 69 D 
---) 1898 28 D 
---> 2008 67 D 
IBR RUNNING 


Overlay RAM is enabled at EGQE-FFFF R/W 
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H - HEXADECIMAL ARITHMETIC 


Purpose 


Enables NICE to add and subtract 16-bit hexadecimal numbers. 


Format 


H First-Number, Second-Number 


After executing the command, NICE sends two values to the terminal: the sum of 
the two numbers appears first, followed by the difference of the two numbers in 
HEX, Decimal, and ASCII. 


Examples 


>?7H 

H Xxexsyyyy 
Calculate sue and difference of two hex nuabers, results are displayed 
as SUM, DIFF in hex, deciaal and ASCII. 

> H 6789,1234 

79BD, S595 31165,21845 = y. ,UU 

>H 98,45 


@0D5,0048 €8213,00875 ..,.K 
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Causes NICE to leave the GO mode and enter the QUIT mode. 


the QUIT mode, the following occur: 


o Full speed execution of Z80 microprocessor is terminated. 


o Interrupts and bus requests are inhibited. 


oA listing of current Z80 registers is sent to the CRT. 


Format 


Transfers eaulator froa RUN aode to QUIT eode. 


F=,...N. ASAE BC =7ALE DE =F9E® HL =81E6 SP=IFAB PC=€637 
"=. 7.V.C A'2OF BC‘=@818 DE'=E@62 HL‘=1FEG IX=07B4 IV=E7EF 1-6 
8637 = 8FE DINZ 8637 
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When NICE enters 


RL - REPEAT LINE 
Purpose 


Causes repeated execution of the command or commands currently on the command 
line. The RL command is especially useful when producing scope loops or looking 


for intermittent problems. 
Format 
RL must be the last command on the command line. 


Examples 


> 7 RL 


RL 
Repeat command line until “C is pressed. 


D 1888, 1828; RL 


1880 4=s SE -@8 OF OF F@ BO OF OF-F8 FQ OF QF FO FO OF OF =. cc eeeeeeeees 
1810 «= @F @F FG FO OF GF FG FO-OF GF FO FO GF OF FO FO ok. ee cece ee eees 
1928 = F@ FO OF GF FO FO OF OF-BO FO OF OF FO FO OF OF wc. cece eeeenene 


1986 3=— SE -@@ GF OF Fa BO OF @F-F@ Fe OF OF FO FO OF OF 8 D...... sa veecews 
1810 = OF «GF Fa FO OF GF FO FO-OF OF FO FO OF OF FO FO .......eee sige 
1828 = F@ FG OF GF FQ FG OF OF-BG FO OF GF FO FO GF OF of. cece eee eee 


1688 8 =©63E 88 OF OF Fe BO OF OF-F@ FO OF OF FO FO OF OF =. cc ceeceseeees 
1816 = @F «GF FQ FQ OF OF FG FO-GF GF FO FO GF OF FO FE occ ccc cece eneee 
1628 «= F@ FO OF OF Fa FO OF OF-BO FO OF OF FO FO OF OF... asccccccees 


1802 = SE @8 OF GF Fa BA OF OF-FO FO GF OF FO FO GF OF dd. ... ccc nee eens 
1818 = OF OF F@ FO OF GF FQ FO-OF OF FO FO OF OF FO FO... cece eee eeee 
1628 = F@ F@ OF OF FO FO OF OF-BG FO GF OF FO FO OF OF oj. cece ween 


188@ = SE @@ OF @F F@ BO OF BF-F@ FO OF OF FO FO BF OF =>. eee e eee 
1610 =F @F FO FO OF OF FO FO-OF QF FQ FO OF QF FO FO LLL. cece eee 
1620 = FO FO OF GF FO FO OF OF-BO FO OF OF FO FO OF OF Lc. ceeececeese 


1680 8=—- SE 00 OF GF Fa BO GF GF-FO FO GF GF FO FO GF OF = >... ccc cceeeeee 
1810 «=F OF FO FO OF OF FO FO-OF OF FO FO OF GF FO FO oc... cece ee ceeee 
1826 «=6FO FO OF GF FO FO OF OF-BO FG OF OF FO FEOF OF oj... cece eee 


1668 = JE «00 OF OF FO Ba OF OF-FO FO OF OF FO FO OF OF = dL... cece eee 
161@ 3=@F GF FG FG OF OF Fe FO-OF OF FO FO OF OF F@ FO & “C abort 
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STS - STATUS 


Purpose 


Shows STS or STS M information about the following: 


Breakpoints 
Printpoints 
Interrupts 

Bus Requests 
Refresh Function 
GO or QUIT mode 


o 0 6 -6~60 =06 


The first three lines of the status display represent the first, second, and third 


software breakpoints respectively. Each line reads like this: 


The first entry represents the breakpoint address. 
The second entry shows the pass counter. 
The "E" or "D" indicates whether the breakpoint is enabled or disabled. 


o 8o 8 86 


A "P" indicates that the printpoint is enabled. A blank indicates that the print- 
point is disabled. 


The fourth line of the status display shows the state of the interrupt, bus request, 
refresh functions, and whether NICE is in GO mode or QUIT mode. An I, B, or R 
indicates the function is enabled, while a period indicates the function is disabled. 


The word "RUNNING" indicates that NICE is in GO mode. 


STSB- - __— displays breakpoint status 
STSH - — displays performance monitoring bucket status 


(see examples) 
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Examples 
« 2? STS 


STS mode 
Display eaulator status. ode aay be one of the following: 
HM - software breakpoint and overlay ram status. 
B - hardware breakpoint status. 
H - histograa bucket status. 


> STS Mf 


~~~) 1888 @9 D 
~--) 1898 28 D 
---> 2088 97 D 
IBR 


Overlay RAM is enabled at E@QQ-FFFF R/U 


> STS B 

@ Addr Catr Init PSE Breakpoint Mode is # DISABLED # 
08 e000 GObs anes... 
G1 @208 G000 GbG8 ... 
02 0808 0008 G060 ... 
G3 GG08 GO06 O008 ... 
04 G808 O808 8000 ... 
@5 €008 G000 G808 ... 
66 G888 8800 G008 ... 
87 G00 e000 G8de ... 
88 8886 8608 0002 ... 
89 G808 G680 Gate... 
OA 8808 G688 8008 ... 
GB GG@8 G000 Geee ... 
OC GR08 8008 G008 ... 
GD G606 8080 G08... 
BE G088 8008 G8G6 ... 
QF G000 O868 C808 ... 


> STS H 


Saaple count = 1080 
# Strt End Count 
08 G800 OFFE e808 
Oi GFFF FFD 8080 
@2 1FFE 2FFC @808 
83 2FFD 3FFB G80 
@4 SFFC 4FFA @008 
05 4FFB SFF9 @008 
@4 SFFA GFFS @808 
07 OFFO 7FF7 8080 
@8 7FFS OFFS G08 
09 SFF7 OFFS 8060 
GA 9FFG AFF4 O000 
QB AFFS BFFS 060 
OC BFF4 CFF2 6008 
OD CFF3 DFF1 0808 
GE DFF2 EFFG @888 
OF EFFI FFFF 8800 
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Z - SLEEP 


Purpose 
Introduces delay into the command line interpreter. 
Format 

Z Delay-—Count 


Each count represents 1 ms of delay. Since Delay-Count is a 16-bit value, you can 


generate delays from 1 ms to as long as 65 seconds. 


The Sleep command is most useful when used in combination with the Repeat Line 


command (RL) to produce scope loops. 
Example 


Below, the Z command is used with the RL command to read data from the I/O port 


Hex '02'. The CRT update is slow enough to be viewed. 


»>?721 


1 xxxx 
Comaand line tiae delay. Delay is in ailliseconds. 


E 8237 168sRL 
~--> €@ 
---) £6 
---)> E@ 
---> E@ 
~--) E@ 
---) £8 
~--> E@ 
---)> €@ 
---) E6@ 
---) £@ 
---) £6 
---> Ef 
---> E@ 
---)> E8 
~-- # “C abort 
> 
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CHAPTER 6 
QUIT MODE COMMANDS 


In QUIT mode, NICE recognizes the following commands: 


Page # 


38 
40 
42 
43 
4h 
45 
47 
48 
50 
51 
54 
56 
57 
59 
61 
62 
63 
65 
67 
65 
65 
70 
68 
69 


68, 71 
71 
72 
72 
73 
73 
74 


A- Assemble into RAM 
D- Display Memory 


E- Examine Input Port 

F- Fill 

G- Go 

L- List in Assembler Format 
M- Move 

MT - Memory Test 

O- Output 

R- Read Intel Hex File 

S- Substitute Into Memory 
SR- Soft Reset 

T - Trace 

U-  Untrace 

UP - Upload 

V- Verify 

X-  Xamine 


EOR - Enable Overlay RAM 

DOR - Disable Overlay RAM 

RO- Set Overlay to R/O Status 

RW - Set Overlay to R/W Status 

PR - Set Performance Monitor Bucket Range 

PRE - Set All Performance Monitor Ranges Evenly 

PRH - Set All Performance Monitor Ranges From Last 
Highest 

PRO - Do Performance Monitoring 

PS - Change Performance Monitoring Sample Count 

SBM - Set Breakpoint Mode 

EBP - Enable Breakpoint 

DBP - Disable Breakpoint 

BPC - Set Breakpoint Counter 

EPP - Enable Printpoint 
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A - ASSEMBLE INTO RAM 
Purpose 


Allows you to enter Z80 assembly language at the terminal. Each line is assembled 


as it is entered; the result is placed in the target system RAM. 
Format 
Two forms of the command are allowed: 


1. A - Begins placing the assembled code at the currently saved memory address. 
The new saved memory address becomes one more than the last byte used in the 


assembly process. 


2. A Start-Address - Begins placing the assembled code at the specified memory 
address. 


Once you enter the command, the terminal displays the memory address which will 
receive the first byte of the assembled code. Following the memory address, you 
enter the desired Z80 assembly language mnemonics and a carriage return. NICE 
assembles the instruction, places it in memory, and displays the address of the next 


instruction. 
If an error in assembly is detected, the address is displayed again so that you can re- 


enter the instruction. This process repeats until you enter a blank. At that time, 
NICE returns to the OK prompt. 
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Examples 


>A 1880 


1988 LD A,98 

1882 OUT @3,A 

1864 LD A,CO 
1886 OUT 2,4 

1808 LD SP,1FAF 

1888 LD A, (IFES) 

{88E CP AS 

181@ CALL NZ,@3Ci 

1813 LD HL, 1800 

1816 CALL 85F4 

1819 JR 72,8821 

# Paraaeter out of range? 
1819 JRZ 8821 
? 

1819 JR 2,0821H 

# Parameter out of range? 
1819 LD H,18 

1818 


D - DISPLAY MEMORY 

Purpose 

Displays the contents of the target system's memory space. 

Format 

Each line of the display begins with the address of the first byte, followed by sixteen 

bytes of data in hexadecimal form. The same sixteen bytes in ASCII form end the 

line. If no ASCII character exists for the corresponding byte, then a period is listed. 

There are three formats for the Display Memory command: 

1. D - Displays memory from the currently saved memory address through the 
next eight lines (128 bytes). Because the saved memory address is always one 
more than the last memory address, using a series of D commands displays 
successive blocks of eight lines of data. 


The saved address is set to zero following power up. 


2. D Start-Address - Displays eight lines of data beginning with the specified 
Start-Address. 


3. D Start-Address, Last-Address - Displays the block of data within the specified 


range. 
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Examples 


20 


D €xxxx(,yyyy}) 


Duap aeaory froa address xxxx to yyyy. 


If xxxx not specified, then 


duap froa last aemory location for 128 bytes. If yyyy not specified 
then duap from xxxx for 128 bytes. 


> D 0008,0828 


e808 
#018 
8028 


06 GB 18 FE 3E 98 DS @3-3E CO D3 @2 31 AF IF SA 
ES iF FE AS C4 Ci @3 21-08 10 CD Fé @5 28 2 26 
18 22 BC 1F 26 @8 18 @A-E3 2B E3 22 £8 IF 18 GE 


> D 8828 


18 22 DC 1F 26 @@ 18 GA-E3 2B £3 22 E8 IF 18 BE 
18 34 22 D2 1F 18 1D 71-E5 2A EE IF €3 C9 32 E7 
1F 2A E@ 1F 3A E2 IF 77-3E 88 D3 @2 3A E7 IF 2A 
£8 1F 08 C9 21 9F 1F 22-D@ IF AF 32 E6 IF DD 21 
9F 87 C3 08 O@ FF 32 £7-1F 3E 98 D3 83 SE CO D3 
@2 3A £7 1F 22 E@ IF E1-22 DE 1F 22 DC IF 2A EB 
IF ED 73 DO 1F 31 DO 1F-FD ES DD ES D9 ES 05 CS 
D9 68 FS @8 ES DS CS F5-ED 57 32 D3 iF SE 80 E2 


A4 88 SE @1 32 D2 1F 31-AF IF 2A DO IF DD 21 BS 
87 28 CD Fé 85 28 19 2B-CD Fé 85 28 13 DD 21 AF 
87 G8 88 11 62 £8 19 36-87 DD 21 B6 IF 37 18 @4 
AF 32 £4 1F 3A £2 1F 2A-E@ IF 77 DC @B @4 31 AF 
1F CD FE @5 CD CB 84 18-F5 FE 18 38 24 21 E6 IF 
CB Cé D6 18 FE @8 21 37-87 DA BO @3 DD 21 86 IF 
Dé @8 21 £4 1F 77 21 E3-1F 36 OM 21 41 @7 C3 BB 
O3 4F 21 4B @7 3A E4 1F-C3 BO 83 21 57 @7 18 FS 


ere ere Cree Cr 
reer ee (.& 
Mietsese te. sea 
seaWe wants wets 
ce Qebeceede 
ve fintes Wesct. ot 
raseduaiet 
Means Lecdaasres 
aes rwar eet 
ee eee ee 
Salaletesee #2..> 
ee dedavlactieets 
oie at eee eee 
Pe ee Pere ee 
shestactaMiael 
Danan eeues -8$!, 
reer Jasess ar 
of eel be AL. 
.O'K.: 'W.. 
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E - EXAMINE INPUT PORT 


Purpose 


Retrieves data from a given I/O port and displays the 8-bit hexadecimal result. The 
specified Port Address must be an 8-bit number. 


Format 


E Port-Address 


Examples 
»7E 


E port 
Exaaine I/O port. 


>E a2 
---) 


2. 


F - FILL 
Purpose 


Loads a block of target system RAM with a given 8-bit constant. A good use of this 


command is to clear target system RAM prior to debugging code. 
Format 
F Start-Address, Last-Address, 8-Bit-Value 


Examples 
>?F 


F xxxx,yyyy,2z 
Fill aemory from xxxx to yyyy with zz. 


> F 2008, 2818,00 
> D 2008,2818 


2088 «=—688 00 8 G8 G8 OG 08 00-88 00 08 06 88 8808 ew... rrrrry 
2018 «80 FF @@ FF 8 FF G8 FF-88 FF GG FF GO FF QO 7F  ........eee acise'e 
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Purpose 


Instructs NICE to enter the GO mode and start the target system running at full 
speed. 


Format 
There are two formats of the GO Command, as shown below: 


1. G - Full speed execution begins at the address contained in the program 


counter. 


2. G Start-Address - Full speed execution begins at the specified address. 


Examples 
>?6 
G (xxxx} 
Transfer from QUIT mode to RUN aode at address xxxx if specified 
else continue from last PC. 


> 6 809F 


EXECUTION BEGINS AT ===> OOF 


4. 


L - LIST IN ASSEMBLER FORMAT 


Purpose 


Disassembles instructions in the target system memory into assembly language 


format. 


Format 


Three forms of the command are illustrated: 


1. 


L - Disassembles 19 consecutive Z80 instructions, beginning with the currently 
saved memory address. As each instruction is disassembled, the new saved 
memory address points to the start of the next instruction. Thus, repeated L 


commands in this form list sequential blocks of 19 instructions. 


L Start-Address - Lists the block of 19 instructions beginning with the specified 
Start-Address. 


L Start-Address, Last-Address - Lists the block of instructions beginning with 
the specified start address and ending with the specified last address. 
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Examples 


rL 
Q639 AF YOR A 
G63 38! OUT 81,4 
G63 7B LD A,E 
@63D 2F CPL 


O63E FOCe = OR C8 
gc4a «D382 «= OUT 82,8 
0642 8686 «=» LD B86 
644 pBee CIN AO 
06457 LD D,A 
647 CBIA = sRR DD 
0649 3882 «9s JR C8440 


648 = =79 LD A,C 
ao4c =88 EX AF AF’ 
64D =OC Inc C 


Q64E 10F7 = DUNT 8647 
@658 023 INC IX 
8652 7B LD A,E 
653 E63F AND 3F 
655 CBA7 sR A 


>L 8980 


e788 «= 216218 «= LD: WL, 18£2 
0983 © CBDA SET 2, (HL) 
e7e5 «SEF LD A,FF 
987 32CDi8 = LD (18CD),A 
e7eA CDU2E © CALL 8€02 
88D CD4AA@C CALL OCaA 
ete! POP HL 
e911 FDEL POP IY 
0713 18C1 JR @9D4 
8915 CDIO@E CALL 8E16 
0718 CDOFSE CALL 8E9F 


Q1B El POP HL 
avic Ci POP BC 
71D = 7A LD A,D 
O71E BB cP B 


Q91F 2804 JR 72,0925 
8921 SEC LD A,@C 
8923 1897 JR #88 


0925 «78 LD ALE 
> L 8999, 899F 

0099°«78 LD (HL) ,B 
99h 28 DEC HL 
e998 C1 POP BC 
@99C FDES PUSH IY 
BI9E DS PUSH DE 
Q09F ES PUSH HL 
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M - MOVE 
Purpose 


Copies a block of target system memory from one location to another. The source 
data may be in ROM or RAM, but the destination must be in RAM. 


Format 
M Start-Address, Last-Address, Destination-Address 


Examples 


74 


M xxxx,yyyy,2222z 
Move eemory block xxxx-yyyy to address 2222. 


> D 8088 
0808 8 8«=684 08 18 FE SE 98 D3 O3-3E CO DS @2 31 AF IF SA wd 
@8i@ = ES 1F FE AS C4 C1 @3 21-88 18 CD FG 85 28 82 26 ww. sien (.& 


8628 8=§=618 22 DC IF 26 @8 18 BA-E3 2B E3 22 £8 IF 18 BE =“. aL He 
8038) 4=— 18 34 22 D2 IF 18 1D 71-ES 2A EE IF ES C9 32 E7 =. 4". get, 
8048 8 8=61F 2A E@ IF 3A E2 IF 77-3E BB D3 82 SA E7 1F 2A tt eee tet 


@@5@ £8 1F 88 C9 21 OF IF 22-DO IF AF 32 EG UF DD 21) wee 2a! 
0068 «© 9F 87 C3 DO OO FF 32 E7-1F 36 9003 03 3E C803 =... a a 
@07@ «= @2 3A. E7 1F 22 £8 1F €1-22 DE IF 22 DC IF QR EB wt... 
> M B088,e028, 2808 

> D 2000, 2828 

2000 «84 OO 18 FE 3E 9@ D3 @3-3E CO D3 82 31 AF IF 3A cde ee Deeeden: 
201@ ES 1F FE AS C4 C1 @3 21-80 10 CD F605 2802 26 ow. bee Ck 


2028 «=: 18 FF @@ FF @@ FF OO FF-08 FF OO FF OB FF O@ FF... scisenaateg 
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MT-MEMORY TEST 
Purpose 
Verifies that the target system RAM is functioning properly. 


NOTE 


The test used is sometimes called the "peaks and 
valleys test." First it tests the RAM by walking a 
one through each bit; then it walks a zero through 
each bit. The process is to write the particular 
pattern throughout the entire range and then go 
back and check each byte to see that it matches 
the pattern written. NICE repeats the process for 
each of the 16 patterns. 


The MT Command takes approximately 15 seconds for each 1K of memory. 


Therefore, you may want to start by checking small blocks of memory. 
Format 


MT Start-Address, Last-Address 


NB dots and explanation points are output to indicate activity. 
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Examples 
>? MT 


AT xxxx,yyyy 
Perfora peaks-and-valley aeaory test from xxxx to yyyy. 


> HT 2288, 2488 


49. 


O - OUTPUT 
Purpose 
Sends one or more 8-bit data bytes to an I/O port. 


Format 
O Port-Address, 1/O-Data, I/O-Data, ... 


The Port-Address and the I/O-Data are 8-bit values. You must supply the 
Port-Address and at least one I/O-Data byte. Any additional I1/O-Data 
bytes, if provided, will also be sent to the I/O port. Sending multiple data 
bytes to an I/O port is especially useful with some of the newer LSI chips 
such as CRT, DMA and Floppy Disk controllers. 


Examples 
>70 


0 port ,data{,data{...3) 
Output data to port. 


> 0 82,54,64,FE,sRL 
#“C abort 
> 0 82,2252 SOsRL 
# “C abort 
> 0 82,FF 


R - READ INTEL HEX FILE 

Purpose 

Loads an Intel Hex file into the target system RAM. 
Format 


A description of the format for an Intel Hex file is given in Appendix B. Two forms 


of the command are allowed: 


1. R - Loads the file directly into RAM at the location indicated by the Intel Hex 


file. 


2. R Offset - Adds the 16-bit offset value to the destination address prior to 
loading the data into RAM. The last record of an Intel Hex file specifies the 
program counter address and the offset is applied to this value as well. This 


form is useful for downloading relocatable code. 


Once you enter the command, NICE only recognizes input which corresponds to an 
Intel Hex file. Each record begins with a colon (2), so NICE looks for a colon at the 
beginning of each record and ignores all other characters. This reduces NICE's 
susceptibility to noise and allows you to switch to a different download device 
following entry of the R command. As with the command line interpreter, all non- 
control characters are reflected as they are received. Thus, you can confirm that 


NICE received the correct sequence of characters. 


NICE exits the command only at the end of the Hex file or when an error is 
detected. 
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NICE responds differently to good records and bad records: 


o If the record is good, NICE sends this sequence: 


ACK, LF, CR 


o = If the record is bad, NICE sends this sequence: 
NAK, xx-ERR, LF, CR 


xx stands for RT (Record Type error), CS (Check Sum error), or HC (invalid 
Hex Code). 


The Intel Hex file is composed of records. NICE processes each record as it is read. 


This means that NICE stores data in the record as it is received. 


NOTE 


When an error occurs, bad data may be stored in 
the target system RAM. To remove the bad data 
and continue downloading the file, issue another 
Read Intel Hex File Command. Begin downloading 
the file with the record that caused the error. 
Because each printable ASCII character is echoed 
as it is received, you may check that each char- 
acter has been received properly by NICE. 


52. 


Examples 


OK zeee)> R 
OF 8OCOOO3IE BOE 1 ABBRICO4FE4O2Z0F ACEO 1 BFEBE 
' 80800081 7F 


Qk seax) X 


...... A880 8C=80@@ ODE=808E HL=a08E S=eee8 P=8888 
eee: A‘=8@ B'=ee6e 0'=e80e H'=e808 X<0008 Y=8008 


Ok ====) 0 8000 


OK «===> R 100 
‘OF BOBCOOIE BOO 1 CBOOICO4FE4OZOFAG6OE 1 BFE8E 
' 90800081 7F 


OK =xaxasn)> X 


Spee Aazee@ BC=e808 DE=8088 HL=90ee S=080e8 P#8108 
fe Cobre Aa‘w66 6826688 0'=0668 H'=0008 X=8008 Y=8000 


OK sa2) O 8108 


8180 3E 6@ 81 60 86 3C 64 FE-40 26 FA 06 00 18 FE 80 
8116 00 66 60 66 66 86 66 80-08 60 86 BE BO BG CO BO 
8120 88 66 66 60 66 G6 BC 80-80 GE OC C8 80 OC 88 G8 
8136 00 6@ 86 60 C8 86 GC O8-80 OG BE BE OG 86 Ge BO 
8148 OC 06 G0 60 OC 60 GC 80-8E OG GE BE GE GE BE OO 
8150 @8 60 06 66 GC C8 60 G8-86 88 BC BEG OG OC BC 60 
8168 OC 60 60 68 86 66 66 GG-08 OC 86 86 G8 O68 GC 80 
8178 0@ 66 66 GC 86 88 CEC 8E6-C0 80 BC BO OE BO BE 60 


OK xexrz)> R 
‘OF 88OC85 RT-ERR 


ERR «z2xxr) 


Pe rd 


ee 
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S - SUBSTITUTE INTO MEMORY 


Purpose 


Allows you to view and optionally enter data into the target system RAM. 


Format 


S Start-Address - Starts at the specified address. 


Once the process is started, the terminal displays the data at the current address. 


At that point you may enter any of the following: 


1. 


A single carrige return. In this case the data at the associated address remains 
unchanged, the current address is incremented, and the next data is byte 


displayed. 


New data to replace the current data followed by a carriage return. The 


current address is then incremented and the next byte displayed. 
data - | hex fj hex# 7 
string } |>9[ String 
ee | . upper char] Uj] . 
SHRINE. Ie E 1 lower char . i 


Note: first and last quote must match. 


A "-" followed by a carriage return. This form is used to back up to a previous 
location and correct an error. The data at the current address is left 
unchanged. The current address is decremented and the previous byte is 


displayed. At that point, you may type any of the options in this list. 


A "." followed by a carriage return. This ends the substitute process and causes 


NICE to return to the command line interpreter. 


Examples 


>7§ 


S xxxx 


Set aemory at address xxxx. Input line foreat: 


X(,X{...3) Where: X 


hex nuaber, foraat: xx{H} 


= string, format: (‘/"Jchar(‘/") 


- to aove to previous address 


S 2808 
2888 @4 ---> FE 
2081 88 ---> 45 
2082 18 ---> 98 
2003 FE ~---> CE 


2084 SE ---> “N" 
2885 98 ---) “I° 
2084 D3 ---> “C* 
2087 @3 ---> “E" 
2088 SE ---> “+" 


2889 CB ---> . 

> D 2008 

2008 = FE 45: 98 CE 46 49 43 45-28 C@ D3 @2 31 AF IF 3A 
2018 = ES 1F FE AS C4 C1 83 21-88 18 CD F4 85 28 82 26 
2028 «=. 18 FF @@ FF @8 FF 68 FF-8@ FF @8 FF 08 FF 88 FF 
2038 «= «7F «@8 FF 88 FF @8 DF-88 FF @@ FF 88 FF 68 FF 
2048 4 8=688 FF 6@ FF 88 FF 88 FF-08 FF 88 FF @8 FF 88 FF 
2050 «= @8 FF @@ FF @8 FF Q@ FF-@8 FF @@ FF 88 FF 8@ FF 
2068 «= 88 FF 08 FF 08 FF 68 FF-8 FF 68 FF 88 FF 68 FF 
2078 «= 8 FF @@ FF 80 FF @@ FF-8@ BF @@ FF @@ FF O@ FF 


oE. NICE+...1..3 


55. 


SR - SOFT RESET 


Purpose 


Clears the Z80 PC and I registers and executes the Z&0 DI instruction. 


simulates a hardware reset to the Z80. 


Examples 
> ? SR 


SR 
Soft reset 788 


F=....N. A=7@ BC =8586 DE =F9C2 HL =85C8 SP=1FAB PC=8088 
F’=,.7.V.C A’=@F BC’=@818 DE’=E@62 HL’=1FE6 IX=1FB7 IY=E7EF 1-08 
8888 8488 LD B,68 


This 


T - TRACE 

Purpose 

Allows you to follow a program through one or more instruction steps. After each 
instruction is executed, NICE displays all internal Z80 registers and flags, as well as 
the mnemonic of the next instruction. The Trace Command is especially useful in 
debugging virgin code. 

Format 

The Trace Command has two formats: 


1, T- Traces the program through one instruction. 


2. T Number-of-Instructions - Traces the program for the specified number of 


instructions. (Number-of-Instructions is a 16-bit value.) 


After NICE traces each instruction, all the Z80 registers and flags are printed at the 
terminal. If breakpoints are enabled, encountering a breakpoint will cause the trace 


sequence to terminate. 


You can start or stop printout by entering CTRL-S, or terminate the command by 
entering CTRL-C. 


57. 


Examples 
€?T 


T (xxxx} 
Trace prograe with register display for xxxx steps. 


>T 


F=....N. A=7@ BC =8886 DE =F9C2 HL =@5CB8 SP=1FAB PC=0082 
F’=.7.V.C A’=OF BC’=@818 DE*=E@62 HL‘=1FE6 IX=1FB7 IY@E7EF I1=08 
8062 18FE DINZ 8882 


»TA 


F=....N. A=78 BC =FF@6 DE =F9C2 HL =85C8 SP=IFAB PC=0082 
F°=.7.V.C A’=OF BC'=@818 DE‘=E@62 HL’=1FE6 IX=1FB7 IY=E7EF 1=88 
8082 18FE DINZ 8882 


F=...0N. A=7@8 BC =FEG6 DE =F9IC2 HL =@5C8 SP=IFAB PC=0882 
F°=.7.V.C A’=@F BC'=8818 DE‘=E@62 HL°=1FE6 IX=1FB7 IY=E7EF 1-08 
8082 10FE DINZ 68Q2 


F=....N. A=78 BC =FD@6 DE =F9C2 HL =@5C8 SP=1FAB PC=8882 
F°=.17.V.C A‘=OF BC’=@818 DE'=E@62 HL’=1FE6 IX=1FB7 IY=E7EF 108 
8082 QFE DINZ 8882 


F=....N. A=78 BC =FC@6 DE =F9C2 HL =@5C8 SP=1FAB PC=8802 


F°=,7.V.C A‘=OF BC’=@018 DE‘=E@62 HL'=1FE6 IX=1FB7 IY=E7EF 1=88 
8882 18FE DINZ 8882 


58. 


U - UNTRACE 

Purpose 

The Untrace Command is identical to the Trace Command except that the Z80 
registers and flags are printed only when the last instruction is traced. It allows you 
to trace a large number of instructions without having to wait for the printout at 
the terminal. 

Format 

The Untrace Command has two forms: 


1. U- Traces the program through one instruction. 


2. U Number-of-Instructions - Traces the program for the specified number of 


instructions. (Number-of-Instructions is a 16-bit value.) 


Enabled breakpoints cause the Untrace Command to terminate and the display to be 
generated. Enabled printpoints are displayed but do not terminate the command. 
When the command terminates, the addresses of the previous four instructions are 


displayed. These are referred to as backtrace addresses -1, -2, -3, and -4. 


59. 


Examples 
>? u 
U {xxxx} 
Trace prograa without register display for xxxx steps. 
>u 
BACK TRACE ------ > ~4=8008 -3=8888 -2=0808 ~1=8056 
F=....N. A=78 BC =EE@6 DE =F9C2 HL =@5C8 SP=1FAB PC=0851 
F°=.7.V.C A'=OF BC'=8018 DE‘=E862 HL‘=1FEG IX=1FB7 IYSE7EF I= 
M851 «IF RRA 
>U 9. 
BACK TRACE ------ > -4=8628 -3=8621 -2=8622 ~1=8623 
F =S.HV.. A=B6 BC =EE@6 DE =F9C2 HL =@7B3 SP=1FAF PC=@8E4 


F°=.7.V.C A’=OF BC’=8818 DE‘=E862 HL‘=1FE6 IX=1FB7 IY=E7EF 1=08 
@GE4 CDCB@S CALL B4CB 


60. 


UP - UPLOAD 


Purpose 


"Dumps target memory between specified addresses in Intel Hex format to the host 
terminal or computer. 


Format 
UP Start-Address, Last-Address 
Example 


>?UP 
UP xxxx, yyyy 
Upload to host ... address range xxxx thru yyyy. 


UF 8170, 8200 

219081 900001F OF DI602F OF DI6OS3F OF DIGO4EOFD4649 
? LOB 1LADOO00CD7EBODCCRBO1 OF SFD7EOLIFDAEOS3274 
' 1081 RBOOOOOF O252007F DCBO1OEFD66022D2007F DFS 
> 1081 COOOCBO2ZOEFD6EO4 1 BD60BSEANDCDADBOOBEDAZ 
21081 D0004D087EA1 CDADSOO0BED4DO0BSEZOCDADBOCF 
? LOS 1EQOOOBFRED4DOSZE21CDADSO008F BED4ADOBIESE 
2 LOB 1LFOOOSSCDADBOOGED4DOBTESSCDADBOOBED4SS2 
2O1820000CDBO 


He pe he om, 


FQOOOOOO0O000 


6}. 


V - VERIFY 
Purpose 


Compares two blocks of memory within the target sytem and indicates any 
differences. 


Format 
V Start-Address, Last-Address, Compare-Address 


Each of the parameters are 16-bit addresses. The Start-Address and Last-Address 
define one of the two blocks of memory as well as the length of both blocks. 
Compare-Address is the starting point of the second block of memory. If there is a 
discrepancy between the data at equivalent locations in the first and second blocks, 
NICE prints the address within the first block, the data at that address, and then the 
data within the second block. 


Examples 


>?Y 

V XXXx ,yyy¥ 2222 
Verify that aemory block xxxx-yyyy matches block of same length 
at address 2222. 


> V BERR , 0828 , 2888 


e200 ---> 06 FE 
8001 ---> 88 45 
e802 ---> 10 96 
0003 ---) FE CE 
o084 -—> SE 4E 
0005 ---> 70 49 
0686 -—-> BS 45 
9087 -—-) 83 45 
oee8 ---> SE 2B 


62. 


xX = 


XAMINE 


The Xamine Command has two forms as indicated below: 


1. 


X - Causes all the Z80 registers and flags to be displayed at the terminal. 


Both the primary and secondary sets of registers are displayed, the primary set 


on the top line and the secondary set on the bottom line. 


The two flag registers are displayed as a series of letters where each character 


represents one bit of the register. The letters represent the various flag bits as 
indicated below: 


S- Sign Flag 

Z- Zero Flag 

-H- Half Carry Flag 

U- Parity or Overflow Flag 
N- Add/Subtract Flag 

C- Carry Flag 


The appropriate character is printed when the bit is set and a period is printed 
when the bit is reset. For example, if the Sign and Carry bits were the only 


ones set, the display would read: 
Scsas € 


X Reg-Id - Displays and allows modification of the internal Z80 registers. Reg- | 
Id indicates the desired register, and may be any of the following: F, F', A, A’, 
B, B', D, D', S, P, X, Y, H, H' or I. 


After the data in the register is displayed, you may enter a carriage return to 
retain the old data, or you may enter new data to replace the old. If you enter 
new data, enter a one byte value for a one byte register and a two byte value 
for a two byte register. If you enter no data, the register remains unchanged. 


63. 


Examples 
»>7X 
X {req} 
Display/Modify 7288 registers. 
Registers are: F, F‘, A, A‘, B, B’, D, D', S, Py X, ¥, Hy H’, I 
Flags are: S, 2, H, U, N, C. 
> xX 
F =S.HV.. A=Bo BC =EE@6 DE =F9C2 HL =87B3 SP=1FAF PC=@QE4 
F°=.7.V.C A’=@F BC’=@618 DE'=E@62 HL‘=1FE6 IX=1FB7 IY=E7EF I=06 
GGE4 CDCB@6 CALL 86CB 
>XP 
P=@QE4 ---> 8624 
>XS 
S=1FAF ---> 1EFC 
> X 
F=S.HV.. A=B6 BC =EE@4 DE =F9C2 HL =@7B3 SP=1EFC PC=8624 


F’=.2.V.C A°=@F BC’=@818 DE‘=E@62 HL‘=1FE6 IX=1FB7 IY=E7EF 1=88 
8624 37 SCF 


64. 


EOR- ENABLE OVERLAY RAM 
EOR enables 8K overlay RAM from base address x000 where x is even. 


> EOR 2888 
> STS 


---)> 6088 88 D 
---) 0808 88 D 
-~-> 8808 88 D 
IBR 


Overlay RAM is enabled at 2@08-3FFF R/W 


The RO and RW instructions define the overlay RAM as Read Only or Read/Write 


respectively. 


> RO 
> S15 


~~~) 8808 88 D 
~-~> 0088 @8 D 
~~~) 8808 88 D 
IBR 


Overlay RAM is enabled at 2@@@-3FFF R/O 


65. 


To overlay ROM area-operating from overlay RAM Q —- 1cee 


> EOR 2088 

> A 0008 ,OFFF 2008 

> EOR 8080 

> STS 

---) 8888 88 D 

-~-) 0888 88 D 

~~~) 0088 @8 D 

IBR 
Overlay RAM is enabled at 8@@@-1FFF R/W 


>68 


Overlay RAM enabled, base address does not 


overlap area where ROM code resides. 


Move contents of ROM to overlay RAM 


Emulator RAM overlays system ROM. 


The GO command is issued and operation 


commences from emulator overlay RAM. 


In this example, overlay RAM is defined as R/W 
because the target system RAM starts at 1800 H 
and the overlay crosses the system RAM/ROM 


boundary. 


DOR -DISABLE OVERLAY RAM 


Disables entire 8K of overlay RAM. It does not change overlay RAM contents. 


> ? DOR 


DOR 
Disable 8k overlay raa. 


€ Q 


F =.7H..C A=3@ BC =4800 DE =<FFCi HL <86£6 SPe1FAB PC=8637 
F°=.7.V.C A’=OF BC’=@816 DE'=F9D@ HL’=1FE6 IX=@79F IY=FFEF 1=@8 
8637 = @FE DINZ 8437 

> DOR 

> STS 


---) 0888 G8 D 
---)> 8288 88 D 
---> 8080 88 D 
IBR 


Overlay RAM is # DISABLED # at @@@@-1FFF R/W 


> 


67. 


PERFORMANCE MONITORING 


Performance monitoring locates the area of program execution and reveals program 


bottlenecks. 


The most general form of the command is: PRE XXXX, YYYY. Where XXXX thru 


YYYY is the address range for which the sixteen buckets are to be evenly distributed. 


PRE evenly distributes the address buckets over the defined range. The monitoring is 


activated by the PRO command. 


In the resulting histogram, 90 percent of program activity occurs in the address range 
of "bucket" number 00H. This range or bucket may be further resolved by issuing the 
command PRH which “breaks down" the bucket; into an additional sixteen evenly 


distributed buckets. 


> PRE 0000, FFFF 


Saaple count = 1000 

00 QOOO-OFFELOFOG $ SeeEEEEEEEEEEEGECEEEEREESEREECECERESECESECEREE 
01 OFFF-1FFD:0000 : 

02 1FFE-2FFC:0000 | 

03 2FFD-3FFB:0000 } 

04 SFFC-4FFA:0000 | 

05 4FFB-SFF9:0000 | 

06 SFFA-6FF8:0000 | 

07 &6FF9-7FF7:0000 | 

08 7FFB-BFF4:0000 | 

09 SFF7-9FFS:0000 | 

OA IFFO-AFF 430000 : 

OB AFFS-BFF3:0000 : 

OC BFF4-CFF220000 : 

OD CFF3-DFF1:0000 | 

OE DFF2-EFFO20000 | 

OF EFFI-FFFFIOOFA { eee 

ee ag ee ge ag yee ae age Gee gag 


 Gtrt-End sCount! 22 102 202 3OL 402 SOL 60% 702 802 902 100% 


68. 


The PRH command can be used to perform several iterations until suitable resolution 


is obtained. The smallest bucket size will have two consecutive locations; to denote 


the upper and lower limits of the "bucket". 


> PRH 


> PRO 


Saeple count = 1000 
00 QOOO-OOFESOECS $ eeeaeeeeceaeeaeeeceeEEEeEEEnteHecacedeceaaease 
01 OOFF-01FD:0000 | 
02 O1FE-02FC:0000 } 
03 O2FD-O3FB:0000 | 
04 O3FC-04FA:0000 | 
05 O4FB-05F9:0000 | 
06 OSFA-06F8:0000 ; 
07 06F9-07F730000 | 
08 07F8-08F4:0000 } 
09 O8F7-09F5:0000 | 
OA O9F6-OAF 420000 § 
OB OAFS-OBF3:0000 { 
OC OBF4-0CF2:0000 : 
OD OCF3-ODF1:0000 } 
OE ODF2-0EF0:0000 } 
OF OEF1-OFFE:0000 | 


# Strt-End sCounti 22 102 202 302 40% S0Z 60% 702% 80% 90% 1002 


> PRH 


00 0000-000E:0000 
01 O00F-0010:0000 
02 001E-0020:0000 
03 0020-0038: OOFF 
04 003C-004A:00€0 
05 0048-0059: 0000 
04 0050-00468: 0000 
07 0069-0077:0382 | steaeeaete 


{ eee 

08 0078-0086:02A0 | eaateset 
H 
} 
H 


#2 


09 0087-0095:0620 | #eaceeteceeeeeetete 
OA 0096-00A4:00E0 | #4 

OB OOAS-00B3:0000 

OC 00B4-0002:0000 

OD 00C3-0001:0000 

OE 0002-0060: 0000 

OF 00E1-00FE: 0000 


@ Strt-End :Count: 22 102 202 302 402% 50Z 602 702 80% 902 1002 


69. 


INDIVIDUAL BUCKET ASSIGNMENT 


Format 


PR n, xxxx, yyyy 


Where n is the bucket number and xxxx, yyyy is the bucket range. Useful for defining 
non-concurrent buckets eliminating areas of no-program activity or to include 


otherwise out of range buckets. 


) PR 0,0033,0037 
) PR 1,0038,003C 
) PR 2,003D,0041 
> PR 3,0044,0068 
> PR 4,0069,006D 
> PR 5,006E ,0072 
> PR 6,0073,0077 
) PR 7,0078,007C 
> PR 8,007D,0081 
> PR 9,0082,0086 
> PR A,0087,0088 
> PR B,008C,0090 
> PR C,0091,0095 
> PR D,0096,009A 
> PR E,009B, 009F 


> PR F,00A0,00A5 


70. 


Saaple count = 1000 
00 0033-0037:0000 + 
01 0038-0030:0189 : 
02 003D-0041:00CF | 
03 0064-0068:0000 : 
04 0069-O06D: 019E | 
05 006E-0072:00CF ¢ 
06 0073-0077: 00CF : 
07 0078-O07C:00CF : 
08 007D-0081:00CF i 
09 0082-0084:00CE § 
OA 0087-008B:0190 | 
OB OOBC-OOT0sO19E | 
OC 0091-0095:026D : 
OD 0096-O09A: 00CF | 
OE 0098-009F 30000 | 
OF 00A0-00A5:0000 : 


@ Strt-End sCount: 


Hit 
€# 


$4242 


22 102 202 302 402 SOL 60% 702 80% M2 1002 


PRO xxxx 


Where xxxx is the address at which the monitoring is to commence 


PRO 


will commence sampling at the address following the last program counter value. 


PS 


sets the sample count up to 1000 , The sample count unless specified will default to 
1000p. 


71. 


EBP - ENABLE BREAKPOINT 


The breakpoints enabled in the Quit mode are effective in the GO mode (operate in 
real time). These breakpoints operate on several modes from which the following can 
be chosen: Memory Request, Memory Recall, Memory Write, on M1, I/O Request, I/O 
Write, and I/O Read. 


Qualification is by address, so setting breakpoints on a memory read operation should 
include the address at which it is performed. 


FORMAT 
EBP x, yyyy, ZZzz 
x = breakpoint number 0 thru F 
yyyy = address 


ZZZZ = pass counter 


‘Set Breakpoint Mode (SBM) 


72 


> ? SBN 


SBN eode 
Set hardware breakpoint aode. Modes ares 
A, AR, MM, M1, I, IR, IW, OB. 


Where M_ is’ breaks on any memory operation 
MR is’ break on any memory read 
MW is break on any memory write 
Ml is break on any instruction fetch 
I is break on any I/O operation 
IR is break on any I/O read 
IW is break on any I/O write 
DB is disable breakpoints on any operation 


A single breakpoint is enabled at address 00041; and coincides with a memory read 


operation. 


BPC _ BREAKPOINT COUNT 


When the breakpoint is encountered (after 9 passes through 0004}4) the instruction at 


this location is executed and the address of the next instruction is displayed with the 


register settings. The pass counter is initialized to its original value. 


Set pass counter for breakpoint (O thru F) to a value (1 thru FFFF) 


FORMAT 
BPCx, yyyy 
Example > EBP 0,4 
> SBM MR 
> BPC 0,9 
> STS B 


# Addr Catr Init PSE 
00 0004 0009 0009 .SE 
01 0000 0000 0000 ... 
02 0000 0000 0000... 
03 0000 0000 0000... 
04 0000 0000 0000... 
05 0000 0000 0000 ... 
06 0000 0000 0000... 
07 0000 0000 0000 ... 
08 0000 0000 0000 ... 
09 0000 0000 0000 ... 
OA 0000 0000 0000 ... 
OB 0000 0000 0000 ... 
OC 0000 0000 0000 ... 
OD 0000 0000 0000 ... 
OE 0000 0000 0000 ... 
OF 0000 0000 0000 ... 
>60 

EXECUTION BEGINS AT = 


Breakpoint Node is MEMRQ and RD 


==) 0000 


> - Breakpoint at 0004 
F =....N. A290 BC =000C DE =F9CA HL =04E6 SP=LFAB PC=0006 
F*=,7.V.C A'=OF BC’=0018 DE’=F9D0 WL‘=IFEG IX=07A1 IY=FFFF 1200 


0006 9303 OUT 


DBP - Disable Breakpoints 


03,A 


The breakpoints are disabled; either one at a time or all at once. 


> ? DBP 


DBP x/ALL 


Disable hardware breakpoint x / ALL breakpoints. 


73. 


EPP - ENABLE PRINTPOINTS 


Printpoints are used with breakpoints to allow NICE Z80 to go through (in RUN mode) 


a large number of instructions while displaying the registers only at specific addresses. 


After the register display, printpoints allow program execution to continue (unlike 
breakpoints which cause the processor to stop at a specified location). 


> EBP 0,4 
> EPP 0 
> SBA HR 


> STS B 

# Addr Cntr Init PSE 
00 0004 0000 0000 PSE 
01 0000 0000 0000 ... 
02 0000 0000 0000 ... 
03 0000 0000 0000 ... 
04 0000 0000 0000 ... 
05 0000 0000 0000 ... 
06 0000 0000 0000 ... 
07 0000 0000 0000 ... 
08 0000 0000 0000 ... 
09 0000 0000 0000 ... 
CA 0000 0000 0000 ... 
OB 0000 0000 0000 ... 
OC 0000 0000 0000 ... 
OD 0000 0000 0000 ... 
GE 0000 0000 0000 ... 
OF 0000 0000 0000 ... 


»>60 


Breakpoint Mode is MEHMRO and RD 


EXECUTION BEGINS AT ===) 0000 


> - Printpoint at 0004 


F =....N. A=90 BC =0018 DE =F9D0 HL =02E6 SP=1FAB PC=0006 
F'=.2.V.C A‘=OF BC‘=QOLE DE’=F9EO HL’=1FE6 IX=O7A3 IY=E72F 1=00 


0006 0303 QUT 03,A 


74, 


APPENDIX A 
QUICK REFERENCE COMMAND LIST 


Quit Mode Only 


A Assemble into memory beginning at the last referenced 


memory address. 


A sa Assemble into memory beginning at the specified start 


address (sa). 


D Display the block of memory beginning at the last refer- 


enced memory address. 


D sa Display the block of memory beginning at the specified start 


address (sa). 


D sa, la Display the block of memory beginning at the specified start 


address (sa) and stopping at the specified last address (la). 

E pa Examine the data at an I/O port address (pa). 

F sa, la, d8 Fill memory from the specified starting address (sa) up to 
and including the specified last addess (la) with the specified 


8 bit data byte (d8). 


G Go into full speed execution starting at the current program 


counter location. 


G sa Go into full speed execution starting at the specified start 


address (sa). 


L List in assembler mnemonics beginning at the last 


referenced memory address. 


A-2. 


L sa, la 


M sa, la, da 


MT sa, la 


O pa, d8, d&, ... 


R off 


SR 


T dl6 


U 


UP sa, la 


U di6 


Quit Mode Only (continued) 


List in assembler mnemonics beginning at the specified 


start address (sa). 


List in assembler mnemonics beginning at the specified start 


address (sa) and stopping at the specified last address (la). 


Move the block of memory between the specified start 
address and the last address to a destination address (da). 


Run a memory test on the target system RAM between the 


specified start address (sa) and a last address (la). 


Qutput to the specified port address (pa) one or more 8-bit 


data bytes. 


Read an Intel hex file and load the data into the target 
system RAM. 


Read an Intel hex file, applying the specified 16-bit offset 
value prior to loading the target system RAM. 


Substitute into memory beginning at the given start address 


(sa). 

Do a soft reset of the Z80 microprocessor. 
Trace one instruction. 

Trace one or more instructions. 

Untrace one instruction. 


UPload to host in Intel Hex format between start address 
(sa) and last address (la) 


Untrace one or more instructions. 


V sa, la, da 


EOR x 

DOR 

RO 

RW 

PR x,yyyy,zzzz 


PRE xxxx,yyyy 


PRH 


PRO xxxx 
PS xxxx 
DPR 


SBM mode 


EBP x( ,yyyy(,zzzz)) 


DBP x/ALL 
BPC x,yyyy 
EPP x 


DPP x/ALL 


Quit Mode Only (continued) 


Verify that the target system memory is the same beginning 
at a given start address (sa) and ending at the last address 


(la) to the data block starting at the destination address 
(da). 


Display all the Z80+ internal registers and flags. 


Display and allow modification of the specified Z80+ 
internal registers. ? can be any one of the given registers: 
? = F, FY, A, A’, B, BY, D, D', H, H’, S, P, X, Y, I 


Enable 8K overlay RAM (at base address x000). 
Disable 8K overlay RAM. 

Set 8K overlay RAM to read-only status. 

Set 8K overlay to read-write status (default). 


Set performance monitoring bucket x to address range yyyy 
thru zzzz. 


Set all performance monitoring buckets evenly over address 
range xxxx thru yyyy. 


Set all performance monitoring buckets evenly over the 
address range defined by the current bucket with the highest 
activity. 

Do performance monitoring starting at address xxxx. 

Set performance monitoring sample counter to xxxx. 


Display last performance monitoring chart. 


Set hardware breakpoint mode. Modes are: 
M, MR, MW, M1, I, IR, IW, DB. 


Enable hardware breakpoint x (at address yyyy) and set pass 
counter to zzzz. Default pass counter to 0. 


Disable hardware breakpoint x / ALL breakpoints. 
Set hardware breakpoint x pass to counter to yyyy. 
Enable hardware printpoint x. 


Disable hardware printpoint x / ALL printpoints. 


SBP 1, d16 


SBP 2, dl6 


SBP 3, dl6 


SBPC 1, d& 


SBPC 2, d& 


SBPC 3, d& 


SEBP 


SEBP n 


SDBP 


SDBP n 


SEPP 


SEPP n 


SDPP 


SDPP n 


Go or QUIT Mode 


Set breakpoint address 1 to the specified 16-bit value (d16). 


Set breakpoint address 2 to the specified 16-bit value (d16). 


Set breakpoint address 3 to the specified 16-bit value (d16). 


Set breakpoint pass counter | to the specified 8-bit value 
(d8). 


Set breakpoint pass counter 2 to the specified 38-bit value 
(d8). 


Set breakpoint pass counter 3 to the specified 8-bit value 
(d8). 


Enable all three breakpoints. 


Enable breakpoint 1, 2, or 3 where (n) is the breakpoint 


number. 
Disable all three breakpoints. 


Disable breakpoint 1, 2, or 3 where (n) is the breakpoint 


number. 


Enable all! printpoints. 


Enable printpoint 1, 2, or 3 where (n) is the printpoint 


number. 
Disable all printpoints. 


Disable printpoint 1, 2, or 3 where (n) is the printpoint 


number. 


EI 


DI 


EB 


DB 


ER 


DR 


H dl6, di6é 


RL 


STS mode 


Z dl6é 


Go or QUIT Mode (continued) 


Enable interrupts to be received by the Z80 from the target 


system. 

Disable interrupts from the target system. 

Enable bus requests to be received from the target system. 
Disable bus requests from the target system. 

Enable NICE's automatic refresh function. 

Disable NICE's automatic refresh function. 


Using hex arithmetic, calculate the sum and difference of 


the two specified 16-bit data values. 
Quit full speed execution. 
Repeat the given command line. 


Display the emulator status, including 
breakpoint addresses 
pass counters 
breakpoint enable or disable 
printpoint enable or disable 
interrupts enable or disable 
bus requests enable or disable 
refresh enable or disable 


emulator mode 


Have the emulator wait a given amount of time before 


executing the next command. 


APPENDIX B 
INTEL HEX FORMAT 


A short Intel Hex File is shown below: 202319300923176 
200310001CE 


Explanations of each field follow: 


Record Mark Field: Frame 0 3: 02319300923176 


The ASCII code for Colon (:) is used to signal the start of a record. 


Record Length Field: Frames 1 and 2 : 02319300923176 


The number of data bytes in the record is represented by two ASCII hexadecimal 
digits in this field. The high-order digit is in frame 1. The maximum number of 
data bytes in a record is 255 (FF in dexadecimal). Two ASCII zeroes in this field 


indicate an end-of-file. 


Regardless of the record type, a zero record length causes NICE to return to the 


command line interpreter following receipt of the checksum field. 


Load Address Field: Frames 3-6 202 3193 00923176 


The four ASCII hexadecimal digits in frames 3-6 give the address at which the data 
is loaded. The high-order digit is in frame 3; the low-order digit is in frame 6. The 
first data byte is stored in the location indicated by the load address; successive 
bytes are stored in successive memory locations. This field in an end-of-file record 
contains zeros or the starting address of program. 


Record Type Field: Frames 7 and 8 2023193 00 923176 


The two ASCII hexadecimal digits in this field specify the record type. The high- 
order digit is in frame 7. All data records are type 0; end-of-file records are type 0 
or 1. Other values for this field are not recognized and will cause an error in the 


downloading process. 
Data Field: Frames 9 to 9 + 2* (record length - 1) :02319300 923176 


A data byte is represented by two frames containing the ASCII characters 0-9 or A- 
F, which represent a hexadecimal value between 0 and FF (0 to 255). The high order 
digit is in the first frame of each pair. There are no data bytes in an end-of file 


record. 
Checksum Field: Frames 9 + 2* (record length) to 9 + 2* (record length + 1) 


2023193009231 76 


APPENDIX C 
TARGET SYSTEM MODIFICATIONS 


CROMEMCO ZPU 


The ZPU card causes the data bus from the system RAM to be disabled for two or 
three cycles following the leading edge of RAM. 


To modify the ZPU card so that it will work with NICE, tie up pin #1 of IC32 
(floating is acceptable). This modifies the ZPU so that the Data Bus In is not 
disabled following the leading edge of MREQ. 


APPENDIX D 
SELF TEST FUNCTIONS 


The NICE Z80+ has the following self-contained test routines: 


Test B: Breakpoint Test performs the following to all 64k break RAM: 


Write 0 to address 
Read HBRK thru PALS 


Display Brk RAM Disable 
Set error at xxxx Breakpoints 
N 
Y 


Display Brk RAM 
Won't disable 


Write 1 to address 
Read HBRK thru PALS 


Display Brk RAM 
Clr error at xXxxx 


Read address 
thru U6, U8 


Address 


Display U6 or U8 


Error Message Repeat 


Test R: 
Simple 00H, FFy test on 2K Z8 ROM Tests write 
Simple 00H, FFY test on 8K overlay RAM Protect circuitry 


RAM failed at xxxx 
Error messages 


Write protect circuitry fail 


Test S: SCOPE TEST 
Writes 00H, FF through the 64K address range of the Z80. 
Use to test chip select circuitry and output latches. 


CAUTION 
You must power down system to exit Test S. 


Test V: 
Scans through all break RAM addresses, displaying all addresses that are set (=0). 


APPENDIX E 
SAMPLE DOWNLOAD PROGRAM USING THE R COMMAND 


OX e«r2) RQ 


FILE MAME © TEST. HEX —— re OE FILE 
§1016QN@0 36 Gaa6aRGE GI Gaal Ede 2sae2Eaa2E G1 AFy 

BELG A1@QOGEG291SF3CSF ICIZGU2dZAGTZEO2ZEALA7TEL Pp ———______________} loaote® DATA 
seaceeuocadt 


OPERATION COMPLETE 
OK *0+26) 0 1860 


1,469 JE @2 Go GA GE BA 16 A@d-1E€ dd 26 Ga 2E Aa JE at i I 
1a:@ @E 92 at SF IC SF XC 32-28 24 2A QO 20 02 BO {8 C62. es 


PROGRAMA CONTENT 


os 


16ae LD a, 28 

19e2 LD 6,83 

{ga4 DC.ea 

1@a6 =D D,aa 

tage DD €,ea@ 

1e@aA WD i aa 

1aac LD LL, aa ; 

162€ CD A,at ——» PROGRAM LISTING 
tet@ LDC. a2 

18t2 ADO A.C 


t@ua iD €.€A 

iai4 inc a 

fais LD €,A 

1406 (rec a 

(e177 (D (2@@9).A 
aa LD HL, (2084) 
14@to JP NC, 18U0 


E-1. 


cz Nicolet 


